WindowItems.htmlTEXTR*ch@2ÆØSÇáØSÇáÅÅßπ AppMaker 2 Reference

AppMaker 2 Reference

Window Items

To create a window item, you first open the Tools window, choose a tool, then click in a view window where you want the top left corner of the item to be. For some items you then enter additional information into an item-specific dialog. For some items you will have an insertion point so that you can enter the title of the item. The following sections provide additional information about each kind of window item.

Button
Checkbox
EditText
Icon
LayerGroup
Line
List
Palette
Picture
Popup
ProgressBar
RadioButton
RadioGroup
Rectangle
Scrollbar
StaticText
TabPanel

Button

To create a button, choose the Button tool, then click where you want the button. AppMaker creates a standard button and puts an insertion point so that you can edit the button's title. After typing a title, click outside the button or press Enter to stop editing.

After creating a button, you can use the Button Info dialog to make it the default button or to change it to a different kind of button:

Standard
To make a 3D button, select a 3D Drawing Style. Alternatively, you can set a 3D Drawing Style for the window and have this button inherit that style from the window.
Graphic
A Graphic button is composed of two graphic images: a "MouseUp" image and a "MouseDown" image. The image can be a PICT, cicn, ICON, SICN, ICN#, or an icon family (e.g. icl8). If the image is an icon (including cicn, etc.), you can omit the MouseDown image; the MouseUp image will be drawn highlighted (darkened) when the mouse is down. If the image is an icon family and the drawing style is 3D, the icon will be drawn inside a round rect frame. You can include a title which will be drawn either below or to the right of the icon depending on the dimensions of the button. See the Everything example for several kinds of graphic buttons.
Invisible
An invisible button inverts its rectangle when the mouse is down.
Rectangular 3D
A rectangular 3D button is a variant of the standard 3D button.
Titled Picture
A Titled Picture draws both a picture and a title.
Bordered Picture
A Bordered Picture draws a picture inside a 2-pixel border.


Checkbox

To create a checkbox, choose the Checkbox tool, then click where you want the checkbox. AppMaker creates a standard checkbox and puts an insertion point so that you can edit its title. After typing a title, click outside the checkbox or press Enter to stop editing.

After creating a checkbox, you can use the Checkbox Info dialog to change it to a different kind of checkbox:

Standard
To make a 3D checkbox, select a 3D Drawing Style. Alternatively, you can set a 3D Drawing Style for the window and have this checkbox inherit that style from the window.
Graphic
A Graphic checkbox is composed of two graphic images: an "Off" image and an "On" image. The image can be a PICT, cicn, ICON, SICN, ICN#, or an icon family (e.g. icl8). If the image is an icon (including cicn, etc.), you can omit the Off image; the On image will be drawn highlighted (darkened) when the mouse is down. If the image is an icon family and the drawing style is 3D, the icon will be drawn inside a round rect frame. You can include a title which will be drawn either below or to the right of the icon depending on the dimensions of the checkbox. See the Everything example for several kinds of graphic controls.
Triangle
A Finder-like right-pointing / down-pointing triangle.


EditText

AppMaker supports four flavors of editable text: small, large, styled, and integer. To add a scrollbar to an edit text item, choose the scrollbar tool, then click near the right or bottom edge of the edit field. To set font, size, style, or text color choose a Text Style.


Icon (obsolete)

The Icon item is superfluous. Both Icon items and Picture items reference an Image which can contain either PICT or icon types. Icon Item will be deleted in a future release of AppMaker and Picture Item will be renamed to Graphic Item.


LayerGroup

A Layer Group is a collection of layers such as many drawing programs provide. It behaves like a radio group in that only one layer at a time is visible. The layer group usually is controlled by a separate window item. A Tab Panel is a special case of layer group that includes both a Tab Control and a layer group.

To create a layer group, choose the LayerGroup tool, then click where you want the group. To create a layer in the group, select the group (if not already selected), then choose Create Layer from the Edit menu. In the Layer Info dialog, enter a Name and an ID. The IDs of layers normally will be numbered 1..N but can be whatever values match the item that controls the layer group. For example, within AppMaker there is a layer group controlled by a popup that produce the values (0, 1, 2, 17776, 577, 578). The IDs of the layers within the group match these values instead of a simple 1..6.

To add items inside each layer, use an Outline window to select a layer. In the View editor the selected layer will be visible and other layers will be hidden.


Line

To create a line, choose the Line tool, then click where you want the top left of the line. Then resize. You can choose a Drawing Style to set line size, line color, and 3D-ness.


List

When you click with the List tool, AppMaker creates a simple text list with a vertical scrollbar. In the List Info dialog you can change the list to another flavor and you can enter a list of values to appear in the list. You can add a horizontal scrollbar to the list by choosing the scrollbar tool then clicking near the bottom edge of the list.

In the current implementation a picture list is used only internally in AppMaker (for displaying the Tools palette). The Panel flavor is not yet implemented. It will let you put several window items (e.g. an icon, some text, and a popup) in each cell of the list. The StoneTable flavor is currently implemented only for Procedural C.


Palette

A palette is a set of objects represented by a picture which is arranged in rows and columns. You create a palette by choosing the Palette tool, then clicking where you want the palette. AppMaker displays the Palette info dialog so that you can select a picture and set the number of rows and columns. You can also enter a frame thickness for the rectangle which will be drawn around the selected item at runtime (or in AppMaker's simulator). A frame size of 0 indicates that the selected cell will be inverted instead of framed.


Picture

When you click with the Picture tool, AppMaker displays an info dialog so that you can choose an image. In the current implementation the image must be a picture. In a future release the image can be any graphic kind. AppMaker will generate the proper code to draw a PICT, cicn, ICN#, etc. You can also specify how to scale the picture if it is larger or smaller than the rectangle of the picture item.


Popup

When you create a Popup item, you can specify the values that appear in the popup either by selecting a menu which you have previously created or by entering a list of values for the popup.


ProgressBar

AppMaker supports several flavors of Progress Bars. The Gadgets example shows some of them.


RadioButton

To create a radio button, choose the Radio Button tool, then click where you want the radio button. AppMaker creates a standard radio button and puts an insertion point so that you can edit its title. After typing a title, click outside the radio button or press Enter to stop editing.

After creating a radio button, you can use the Radio Button Info dialog to change it to a different kind of radio button:

Standard
To make a 3D radio button, select a 3D Drawing Style. Alternatively, you can set a 3D Drawing Style for the window and have this radio button inherit that style from the window.
Graphic
A Graphic radio button is composed of two graphic images: an "Off" image and an "On" image. The image can be a PICT, cicn, ICON, SICN, ICN#, or an icon family (e.g. icl8). If the image is an icon (including cicn, etc.), you can omit the Off image; the On image will be drawn highlighted (darkened) when the mouse is down. If the image is an icon family and the drawing style is 3D, the icon will be drawn inside a round rect frame. You can include a title which will be drawn either below or to the right of the icon depending on the dimensions of the radio button. See the Everything example for several kinds of graphic controls.
Text
A Text radio button draws text with the On button of the group drawn in a different style, e.g. underlined. An example is the Finder's Name, Size, and Kind column headers.


RadioGroup

A Radio Group serves two purposes: It provides visual grouping of its contents; It provides the functional behavior of radio buttons. When you create radio buttons they should always be inside a radio group. You can also use a radio group without any nested radio buttons just to provide the visual grouping.

When you create a Radio Group you can have AppMaker create the radio buttons for you or you can manually create them yourself. If you enter values into the values list AppMaker will create a radio button for each value.

If you leave the group's title empty, AppMaker will create an invisible group that provides the radio function without the visual grouping.


Rectangle

A Rectangle is used for visual grouping of its contained items. If you provide a title it will have the same appearance as a radio group but without the functional behavior of a radio group.

You can choose a Drawing Style to create a 3D appearance of a Primary box (grooved), a Secondary box (inset), or raised.


Scrollbar

Scrollbars are used in two different ways. One is to scroll a rectangular area, possibly the entire window or perhaps just an edit text field or a list. The second use for a scrollbar is as a freee-standing control for setting a value. The first use might be called a scroller bar, the second a slider.

To create a scroller bar on an item, or on the entire window, click near the right edge or the bottom edge of the item (or window).

To create a slider, click where you want the item (but not too close to an edge). In the Scrollbar Info dialog you can choose from several different flavors of slider. For a picture slider, you can specify a picture to be used as the background of the slider and a picture to be used as the indicator.


StaticText

What is there to say about Static Text? You can type directly in place or into the Info dialog. You can set a Text Style.


TabPanel

A Tab Panel is a kind of Layer Group that includes a Tab control for selecting layers. Each tab of the tab control corresponds to a layer of the layer group. When you create a tab panel you enter two or more labels. For each label, AppMaker automatically creates a nested layer with a matching Name and with IDs from 1..N.

If you leave the Tab Height empty it defaults to 20. If you omit "Tabs per row" it defaults to 4. You can have more than four labels. They will appear on multiple rows or you can change the number of Tabs per row.


hhFE#.¡CODE$ÊCODE%/DDATAWindowItems.htmlsTEXTR*chTEXTR*ch≤0±‡Ø0ä@2Ættiestohid nd witlir ecedctngator, an fdiildo.laˇchckvewiˇ˛becaowicus dac˛meouopelioavfig peetst lro nclk a aieaboha**nocoaH Monaco√˛0ép°"∂k@]Wk@]WØSJGddR*chÅHH¯HˇˆˇÚV,(¸hhÿ hd'0ˇŒˇ∫F Æ Monaco  Helvetica ConfidentialÄÄÄÄHhhF∂¢0! FMPSRBBSTÌˇˇÄˇˇL∂ö‰